3D Graphics Programming with QuickDraw 3D 1.5.4

Notice Methods

Your application can define a standard notice method that is called at specific times (for example, when the renderer is finished rendering an image). You can also define a buffer notice method to handle buffer-related notifications.

A pointer to your notice method is passed as a parameter to the QASetNoticeMethod function.

TQAStandardNoticeMethod

An application can define a method to respond asynchronously to certain events associated with the operation of QuickDraw 3D RAVE.



 
typedef void (*TQAStandardNoticeMethod)

                     (const TQADrawContext *drawContext, void *refCon);

drawContext: A draw context.
refCon: The reference constant associated with the notice method.

DESCRIPTION

Your TQAStandardNoticeMethod function is called by QuickDraw 3D RAVE at the times specified when an application installed the notice method using the QASetNoticeMethod function. For example, if the value of the method parameter passed to QASetNoticeMethod was kQAMethod_RenderCompletion , then the standard notice method is called whenever the renderer finishes rendering an image in the draw context specified by the drawContext parameter. The refCon parameter is an application-defined reference constant; this is simply the value of the refCon parameter that was passed to QASetNoticeMethod .

You can install one notice method for each defined notice selector. See page [link] for a description of the available notice selectors.

TQABufferNoticeMethod

An application can define a method to respond asynchronously to certain events associated with the operation of QuickDraw 3D RAVE buffers.



 
typedef void (*TQABufferNoticeMethod)

                     (const TQADrawContext *drawContext, 

                      const TQADevice *buffer,

                      const TQARect *dirtyRect,

                      void *refCon);

drawContext: A draw context.
buffer: The back buffer.
dirtyRect: A pointer to a rectangle describing the smallest area to update. If this parameter is NULL , you should process the entire buffer.
refCon: The reference constant associated with the notice method.

DESCRIPTION

Your TQABufferNoticeMethod function is called by QuickDraw 3D RAVE to handle a buffer-specific notification. Currently, your buffer notice method might receive kQAMethod_BufferInitialize or kQAMethod_BufferInitialize notifications. On entry, the buffer parameter is a reference to the affected buffer.

The refCon parameter is an application-defined reference constant; this is simply the value of the refCon parameter that was passed to QASetNoticeMethod .

You can install one notice method for each defined notice selector. See page [link] for a description of the available notice selectors.